package com.wpan.common.valid;

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import static java.lang.annotation.ElementType.*;
import static java.lang.annotation.RetentionPolicy.RUNTIME;

/**
 * 这是一个自定义的效验注解
 *  注解上面的注解也是按照原生的注解来 写的
 */
@Documented
/*
    @Constraint(validatedBy = { })
        validatedBy = { }   指定用什么东西来效验
            需要指定一个数组    并且它的类型是 ConstraintValidator
            与指定的效验器 产生关联
 */
@Constraint(validatedBy = { ListConstraintValidator.class })
@Target({METHOD,FIELD,ANNOTATION_TYPE,CONSTRUCTOR,PARAMETER,TYPE_USE})
@Retention(RUNTIME)
public @interface ListValue {
    /*
        首先这个效验注解必须满足规范 JSR303
            这个效验注解必须拥有三个属性
                message     当效验出错以后 错误信息在哪里
                groups      也需要支持空值校验
                Payload     自定义效验 也需要可以自定义一些负载信息
     */

    /*
        这个message 可以是一个变量 而参数为 这全类名
        它会在配置文件中取出它配置的消息来作为错误提示
            在JSR303中ValidationMessage中 当前也可以自己创建一个配置文件
     */
    String message() default "必须提交指定的值";

    Class<?>[] groups() default { };

    Class<? extends Payload> [] payload() default { };

    /*
        注解所需要包含的数据
     */
    int[] vals() default {};
}
